DeepSeek Harness极简入门:为什么大家都在问“Why Not Pi?”
DeepSeek Harness极简入门:为什么大家都在问“Why Not Pi?”
GnaixEuy先说人话:它到底是什么?
如果你只是想找一个顺手的代码Agent,现在有更省心的选择;DeepSeek Harness真正想做的,是把Agent身上的零件也变成随时能装、能换、能拆的插件。
先别管Harness这个英文名。
你可以把它当成DeepSeek做的一套本地AI助手。选中一个项目文件夹,它就能读文件、改代码、跑命令,遇到报错还能接着处理。平时用过Codex或者Claude Code的话,大概就是这类产品。
DeepSeek Harness发出来以后,X上问得最多的是:已经有Pi了,为什么还要再做一个?
没听过Pi也没关系。它是另一个开源代码Agent,能做的事情和DeepSeek Harness很像,而且现在更轻、更顺手。
我把DeepSeek Harness装起来跑了一圈。单纯拿来写代码,我现在还是会开Pi、Codex或者Claude Code。DeepSeek这套东西真正特别的地方,藏在普通用户不太会注意的插件系统里。
为什么大家总拿它和Pi比?
两边都能通过插件增加功能。插件可以理解成给软件加上的小零件,比如文件搜索、网页截图或者公司工单查询。
Pi的做法很直接:缺什么就装什么。比如我只想让它查公司的Jira工单,写个小扩展,能查就完事了。
DeepSeek多管了一步:插件怎么装进去,删掉以后又该怎么收尾。
举个直白点的例子。一个监控文件的插件被删掉了,它之前启动的监控也应该一起停,不能插件没了,后台还在偷偷跑。插件多起来以后,这种烂摊子并不少。
Pi通常让插件作者自己处理,DeepSeek则做了一套叫Cordis的底层框架来统一收尾。普通人写完代码就关掉,这层东西大概率用不上;Agent如果要一直挂在后台,今天装这个、明天换那个,才会慢慢遇到这些问题。
这次DeepSeek发的到底是什么?
DeepSeek V4 Pro正式发布的第二天,预告了很久的Agent产品也跟着来了。它没叫DeepSeek Code,也没叫DeepSeek Agent,名字很工程:DeepSeek Harness。
官方给它定的理念是:一切皆插件。
我写这篇时,它在GitHub已经有6.24万Star。
Harness不是工具箱
官网直接给了一条公式。
Agent = Model + Harness。
智能体 = 模型 + 一套让模型真正干活的运行系统。
Harness直译很别扭,你把它理解成“模型外面那套干活环境”就行。
同一个模型放在普通聊天框里,只会告诉你代码应该怎么改;放进Codex或者Claude Code,它会自己找文件、改代码、跑测试,失败了再接着修。多出来的这套东西就是Harness。
工具调用、Skills、会话、权限、上下文和Agent循环都算。Codex已经把这些包好了,平时用不到你管。
DeepSeek则把这些东西全拆开了。模型适配器、工具、会话日志、Agent循环,连Web界面都是插件。删掉一批、换掉一批,就能拼出另一套Agent。
管这些插件的底层框架叫Cordis。DeepSeek还配了一篇88页论文,专门讲它为什么要这么设计。
Cordis主要管插件怎么装、怎么拆,还有插件之间的依赖。论文给它们起了两个很学术的名字。
一个叫Temporal composability,时间可组合性。
比如你装了一个“监控日志”的插件。它注册了一个工具,启动了一个定时器,还打开了文件监听。卸载插件时,这些东西应该一起停掉。不能界面上看着插件已经没了,后台定时器还在跑,过几分钟又往会话里塞一条消息。
另一个叫Spatial composability,空间可组合性。
还是举例。一个“网页截图分析”插件同时依赖浏览器和视觉模型。视觉模型从A换成B,它要能重新接到B上;视觉模型被卸载,它就应该停下来说明缺少依赖,而不是拿着一条已经失效的连接继续跑。
这两个概念实际管的就是插件依赖和卸载清理,名字比事情本身复杂。
有人把这套东西叫“自进化Agent”,我觉得吹早了。目前能看到的只是Agent可以在运行时写插件、装插件和卸插件,写出来的东西靠不靠谱还是得测。
现在这个代码Agent更像Cordis的演示项目,本身就是由一批官方插件拼出来的。
官方自己也写了Developer Preview,还特别提醒后面会有破坏性改动。想尝鲜可以,别急着搬家。哪天升级把插件和配置干废了,也算正常发挥。
装起来以后,离成品还有多远?
官方网址在此:
https://www.deepseek.com/harness/
安装命令:
1 | npx @deepseek-ai/dsh web |
如果你平时不碰Node.js,也不用专门去学。把这条命令扔给任何一个本地代码Agent,让它帮你安装就行。
打开终端给出的本地网址,再填入DeepSeek API Key,账号里需要有余额。
目前只有WebUI,不过界面本身也能换。模型可选Flash或Pro,思考强度也能调。
价格这块就没那么轻松了。DeepSeek这次顺手涨了一轮,而且不算客气。
V4 Pro缓存命中涨了12倍,高峰期输出到了27元。至少在价格上,它已经不是以前那个闭眼充钱的DeepSeek了。
前几天X上还在刷“梁圣”,拿DeepSeek画“AI斩杀线”;价格一公布,称号就从“梁圣”降成了“梁子”,还有人直接叫“牢梁”。梁圣这一刀,先斩到的好像是自己的性价比。至于公司急不急着赚钱,梁老板背后毕竟还有幻方量化,工作日九点半,梁子自有印钞机为他辩经,网友替他操心可能有点多;我们还是先操心自己的API账单吧。
和GLM、Qwen 3.8 Max放一起,DeepSeek已经没法只靠便宜赢了。好在Harness不锁模型,Base URL、协议和模型列表都能自己填。
我这里接入了OpenCode Go。选好模型后,再添加一个项目目录,Agent默认就在这个目录里干活。
四种运行模式
四个名字看着唬人,区别只在默认插件,底下用的都是Cordis。
1. 标准模式
第一次用就选标准模式,别纠结。文件编辑、Shell、搜索、Skills、计划、后台任务、子Agent和工作流都在,最接近Codex或者Claude Code。
2. PTC模式
PTC和标准模式的区别主要在工具怎么调。标准模式一次调一个工具;PTC让模型写TypeScript,在一次run_code里串起多步操作。
比如检查20份JSON日志并统计401错误,PTC可以一口气完成找文件、解析、过滤和汇总。重复操作多时确实省来回,但也更考验模型写代码和处理异常的能力,平时没必要硬开。
3. 极简模式
极简模式只留持久Bash和文件编辑器,系统提示词也只剩一句“你是一个有帮助的软件工程助手”,计划、Skills、子Agent和上下文压缩基本都拿掉了。
拿同一个仓库、同一个Bug测试不同模型时,它更容易看出模型本身的Agent能力。普通用户直接跳过,少几个插件不会更专业,只会更难用。
4. 创造模式
创造模式是四个里面最有意思的,也最像官方拿来秀Cordis的Demo。它有标准模式的全部能力,还能查看当前环境、临时加载插件,甚至再做一套新的Agent预设。
比如排查网页问题时,它能读代码,但看不了截图。创造模式可以临时接一个视觉模型,加载成功以后继续查。好用就留下,不好用直接拆。
想法挺带劲,问题也很现实:Agent现场写出来的插件靠不靠谱、权限有没有给多,最后都得测。Cordis能负责装和拆,不能保证Agent写出来的东西一定没坑。
我觉得比较实用的几个社区插件
第一方插件在设置页就能看到,社区里也已经有人替它补短板。
- dsh-at-file
https://github.com/omdsh-dev/dsh-at-file
装完以后,可以在输入框里用@引用文件。这个本来就应该是基础功能。
- DSH-better-sidebar
https://github.com/omdsh-dev/DSH-better-sidebar
把文件管理、代码编辑、终端、Git、Diff和内嵌浏览器塞进侧栏,思路很像VS Code。对准备拿DSH写代码的人来说,这类基础工作区比换皮肤实用得多。
- ModLens
https://github.com/liustack/modlens
给纯文本模型接上视觉通道。配置好以后,可以直接往对话里粘贴图片,让它做OCR、识别布局和分析截图。排查网页和界面问题时很好用。
- dsh-web-ui
https://github.com/zhu1090093659/dsh-web-ui
dsh-web-ui把任务看板、Git图谱、文件和变更面板、Token统计、手机远程打包在了一起。功能很多,建议按需安装,没必要看到“全家桶”就全部打开。
- dsh-TUI
https://github.com/ccch1mneyyy/dsh-TUI
不喜欢浏览器的可以看它。它给DSH补了一套接近Claude Code的终端界面,能看工具状态、上下文占用和生成速度,也支持双击Esc回退。官方目前只有WebUI,这个补位很直接。
- dsh-agent-teams
https://github.com/NanmiCoder/dsh-agent-teams
让一个会话临时拉起多名子Agent,分任务、处理依赖、互相发消息。适合调研和大一点的代码任务;小活就别开团队了,三个人开会不一定比一个人干活快。
这些插件都还很新。能碰终端、SSH和定时任务的,我不敢闭眼装,至少先扫一遍权限和安装脚本。
我的结论
如果只想知道现在值不值得装,我的建议很直接:
- 想找一个日常写代码的主力工具,不推荐。Pi、Codex和Claude Code都更省心。
- 想研究Agent怎么在运行时安装、替换和卸载插件,可以折腾。Cordis才是这次真正的新东西。
- 只是想尝鲜,又不想处理配置被改坏、插件互相冲突这些问题,那就先等等。
我不推荐拿它当主力,不是因为一句“WebUI还粗”。具体一点:输入框连@引用文件都要装社区插件,视觉、文件管理和终端也得自己补;官方还明确写着后面可能有破坏性更新。现在把项目搬过去,得到的未必是更强的代码能力,更可能是多养一套配置。
X上有人拿这次Harness开炮:88页论文先端上来了,产品却像个花架子,DeepSeek是不是招了一群只会写Paper的人?
Harness这次确实没把产品体验做好,该骂。但把整个团队都说成花架子也不对,DeepSeek以前做出来的模型又不是PPT。这次的问题很具体:论文讲的是插件卸载后怎么清理定时器、依赖变化后怎么重新连接;用户打开产品,先碰到的却是文件引用都要自己装插件。两边根本没对上。
Cordis做的事情有用,只是暂时还没变成普通用户能直接感受到的好处。为了把底层做得更完整,产品更重、发布更慢,这就是技术理想主义要付的账。梁老板急不急另说,毕竟人家背后还有幻方量化;我们没有,DeepSeek API涨价以后还是先看自己的账单。
所以我会继续看Cordis,但不会把项目搬到Harness。哪天它真拿出一个Pi做不到、我又确实需要的功能,再谈替代。
“深度求索”这次确实求得够深,只是离顺手还差得有点远。
相关资料
- Pi官网:https://pi.dev/
- Pi开源仓库:https://github.com/badlogic/pi-mono
- DeepSeek Harness架构文档:https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md
- Cordis论文:https://github.com/cordiverse/paper
- 梁文锋与幻方量化背景(AP):https://apnews.com/article/0673d5c39d90108189cc31b88d85b9f8

























